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Problem Reporting 


Preface 

This dcxument provides the following information: 

• features 

• installation information 

• related documentation 

• problem descriptions and fixes and known limitations 

Note: The software code printed in the release notes title indicates the 
software product version at the time of release. Some product and 
operating system changes do not require changes to documentation; 
therefore, do not expect a one-to-one correspondence between these 
changes and release notes updates. 

Latest printing:] une, 1999 

This document resides online in the file 

/opt/aCC/newconfig/RelNotes/ACXX.release.notes. You can print the 
online copy by using an ip command I ike the foil owing: 

Ip — dprint0'_narnG /opt/aCC/newconfig/RelNotes/ACXX.release.notes 

If you have any problems with the software or documentation, please 
contact your local Hewlett-Packard Sales Office or Customer Service 
Center. 
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Features 

Version A.01.21 Features 


Features 


This chapter summarizes the features included in this version of the HP 
aC++compiler. Features introduced in prior release versions are also 
listed and grouped by the compiler version number. 

The compiler supports much of the I SO/ I EC 14882 Standard for the C++ 
Programming Language (the international standard for C++). 


Version A.01.21 Features 

New and changed features in this H P aC++version A.01.21 are listed 
below. They apply to HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.). 

• The latest linker patch (PHSS_17903) is needed to build shared 
libraries and to use the new -Fobjdebug option. See these release 
notes, Chapter 2, Current Linker Required, for details. 

• A new debugging option , -Fobjdebug, enables faster links and smaller 
executable file sizes for large applications. 

• Header File Caching is an additional, simplified method of 
precompiling header files. 

• Additional Options for Standardizing Your Code: 

• -Wc,-ansi_for_scope,[on] enables standard scopi ng rules for 
init-declarations in "for" statements. 

• -Aa sets all C-F+standard options on (currently Koenig lookup and 
"for" scoping rules). 

• Additional Options for Standardizing Your Code: 

• -Wc,-ansi_for_scope,[on] enables standard scopi ng rules for 
init-declarations in "for" statements. 


Chapter 1 
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Features 

Version A.01.21 Features 


• -Aa sets all C++standard opt ion son (currently Koenig lookup and 
"for" scoping rules). 

• Additional Options for Code Optimization: 

• +OoptlB/el#=namel[,name2,...,nameN] 

• +Oreusedir=DirectoryPath 

• A new template option, +inst_directed, to suppress assignor output in 
object files. Use it instead of the+inst_none option with code that 
contains explicit instantiations only and does not require automatic 
(assignor) instantiation. 

• The pragma pack directive allows you to specify the maximum 
alignment of class fields having non-class types. This pragma may be 
useful when importing code from other architectures where data type 
alignment may be different from default PA-RISC alignment. 

• Three new pragmas for improving performance of shared libraries. 

• By eliminating references to the standard header files and libraries 
bundled with H P aC-i-+, the -mostl option allows experienced users 
full control over the header files and libraries used in the compilation 
and linking of their applications. 

• Additional information about HP aC-H-diagnostic messages is 
provided in the HP aC-H-Online Programmer's Guide and the HP 
aC-H-Transit!on Guide 

• Tosee which include files led to an error or warning, specify the 
-Wc,-diagnose_includes,on option. 

• With floating installation, more than one version of HP aC-H-can be 
installed on one system at the same time. 

• The_HP_aCC predefined macro now contains the H P aC-H-driver 

version number. For version A.01.21: _H P_aCC =012100 

The_HP_aCC predefined macro was introduced in HP aC-H-version 

A.01.15. It's value was Ifor HP aC-H-A.01.15 and A.01.18. 

• In prior releases, the standard C-H-library (libstd) and RogueWave's 
tools.h-i-+library (Iibrwtool) were not thread safe in all cases. The 

-D_H PACC_TH READ_SAFE_RB_TREE preprocessor macro insures 

thread safety. 
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Features 

Version A.01.15 Features 


Version A.01.15 Features 

Features introduced in the prior release, HP aC++version A.01.15, are 
listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.). 

• TheHP aC-H-OnlineProgrammer'sGuidehas been updated from HP 
CDE format to HTML format viewable with your HTML browser. For 
details and access instructions, see Chapter 3 of these release notes 
under Online Documentation. 

• Standards based features include the foil owing: 

• covariant return types (except for covariant return types with 
multiply inheriting types) 

• Koenig lookup 

Note: You must specify the-Wc,-koenig_lookup,on option. 

• .The-I-header file option invokes view-pathing. Thisoption 
overrides the default-I <directory>option header file search path. 

• Additional options for verbose compile and link information: 

• -Fdryrun - Requests compiler subprocess information without 
runni ng the subprocesses. 

• -rtime - Requests subprocess execution times. 

• -V - Requests the current compiler and linker version numbers. 

• -fM [d] and -HTi[d] options to output the header files upon which your 
source code depends i n a format accepted by the make(l) command. 

• -FWe option allows you to selectively interpret a warning or future 
error as an error. 

• The_HP_aCC predefined macro identifies the H P aC-H-compiler. 

• At this release, the-Finline-level option defaults to 1. Intheprior 
versions, A.01.09, A.01.12, A.03.05, A.03.10, the default was 0, no 
inlining was done (the same effect as the 4d option). 

This change was made based on customer feedback regarding object 
file size and runtime performance. 


Chapter 1 


9 




Features 

Version A.01.07 Features 


Version A.01.07 Features 

Features introduced in the prior release, H P aC++version A.01.07, are 

listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

The HP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 

(See Chapter 3 of these release notes for access instructions.). 

• The aC-H-default template instantiation mechanism has changed to 
compile-time instantiation (CTTI). For source code containing 
templates, the new default may result in faster compile-time 
processing. 

The previous default behavior remains available by specifying the 
-Hnst_auto command-line option when compiling and linking. If you 
provide archive or shared libraries for distribution, you may want to 
use -Hnst_auto to insure consistent behavior between each 
distribution of your libraries. 

Also, if you provide either archive or shared library products, and 
your customers need to use the prior tempi ate instantiation default in 
their builds, you must compile your libraries by using the-i-inst_auto 
option. 

Refer to the H P aC-H-Online Programmer's Guide and to the online 
technical paper. Using Templates in HP aC-H-, for details about 
template instantiation and migration. For access instructions, see 
Chapter 3 of these release notes under Online Documentation.. 

• Member templates are supported, including those in pre-compiled 
headers. 

• Updated versions of the Rogue Wave Standard C-H-Library (version 
1.2.1) and theTools.h-l-l-Foundation Class Library (version 7.0.6) are 
provided. HTML documentation for these libraries is also updated; 
seeChapter 3 of these release notes under Online Documentation. 

• The HP aC-H-OnlineProgrammer's Guide has been updated, 
including additional migration and template information. For access 
instructions, seeChapter 3 of these release notes under Online 
Documentation. 
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Features 

Version A.01.04 Features 


• The technical paper, Using Templates in HP aC++, has been updated 
to describe the new default, compile-time template mechanism and 
additional information about template libraries. For access 
instructions, see Chapter 3 of these release notes under Online 
Documentation. 


Version A.01.04 Features 

Features introduced in the prior release, H P aC-H-version A.01.04, are 

listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 

(See Chapter 3 of these release notes for access instructions.) 

• -FESsfc — option to replace millicodecalls with inline code when 
performing simple function pointer comparisons. 

• -Hnline_level — option to control how C-H-inlining hints influence H P 
aC-H-. 

• -Hj — option to allow pointers to access non-natively aligned data. 
This option alters the way that the compiler accesses dereferenced 
data. Use of this option may reduce the efficiency of generated code. 

• -fW — option to selectively suppress warning messages. 

• Support for new style casts as defined in the proposed C-H-standard. 
The keywords const_cast, reinterpret_cast, and static_cast are 
supported. 

• Partial support for the namespace and using keywords. User 
namespaces are supported. Standard C-H-Library components not in 
namespace std:: are not supported. Koenig lookup is not supported. 

• Support for class template partial specializations. 

• Extensiveonlinedocumentation is provided, including the first 
edition of the technical document. Using Templates in HP aC-H-. 
Refer to Chapter 3 of these release notes for details. 

• H P aC-H-now supports level 4 optimization. The-K)4 compile-line 
option is supported. 


Chapter 1 
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Features 

Version A.01.00 Features 

• H P aC++now supports profile-based optimization. The compile-line 
options 4dfname, -H, 4P and -Fpgmname are supported. 


Version A.01.00 Features 

Features introduced in the prior release, HP aC-H-version A.01.00, are 
listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

The HP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.) 

• I mproved error messages allow you to quickly isolate problems in 
your code. 

• Pre-compiled header files help you speed development substantially. 
Use them to reduce compilation time and object file size. 

• An automatic template instantiation mechanism is provided. (Note, 
as of H P aC-H-version A.01.05, this mechanism is no longer the 
default, although it is available by specifying the-i-inst_auto 
command-line option.) 

• Explicit template instantiation (defined by the draft standard) is 
supported. 

• Application thread-safe exception handling in shared libraries is 
supported. 

• I niine functions are aggressively inlined. 

• Standards based features include the foil owing: 

• keywords: bool, dynamic_cast, explicit, mutable, typeid, typename, 
volatile, wchar_t 

• class: type_info 

• explicit template instantiation 

• overloading new and delete for arrays 

• standard exception classes 

• The following libraries are provided: 
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Features 

Version A.01.00 Features 


• Rogue Wave Standard C++Library Version 1.2.0, includes STL 
(updated at HP aC++Version A. 01.07 to library version 1.2.1) 

• Rogue Wave Tools. h++Version 7.0.2 Foundation Class Library 
(updated at H P aC++Version A.01.07 to library version 7.0.6) 

• cfront compatible I ostream Library 

• Standard Components L i brary (obsol ete) 

• Extensiveonlinedocumentation is provided. Refer to Chapter 3 of 
these release notes. 

• +DA designations for PA-RI SC 2.0 model and processor numbers —to 
generate code for the PA-RI SC 2.0 systems. The -FDAportable option 
will generate code compatible across PA-RI SC l.land 2.0 
workstations and servers. 

Default architecture object codegeneration is now determined 
automatically for all systems as that of the machine on which you 
compile. 

• -fDS designations for PA-RI SC 2.0 model and processor numbers - to 
perform instruction scheduling tuned for PA-RI SC 2.0 systems. 

Default instruction scheduling is now determined automatically for 
all systems as that of the machine on which you compile, or on the 
setting of -FDA, if it is specified. 

• option -l:<library>— to support the Id feature. 

• -FESfic option - to replace millicode calls with inline code for fast 
indirect calls. 

• 64-bit integral data types (long long and unsigned long long) are 
supported for HP aC-F+applications needing large integers, such as 
large file system databases. Use the-ext command line option to 
specify. 

• HP aC-F+features are supported by the HP Distributed Debugging 
Environment (DDE). 

• The -Fhelp option invokes online help for the H P aC-F+compiler and 
linker and libraries. 


Chapter 1 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


Migrating from HP C++(cfront) to HP 
aC++ 

The compiler lists Errors, Future Errors and Warnings. Expect to see 
more warnings, errors and future errors reported in your code, many 
related to standards based syntax. For more complete information, refer 
to: 

1. FI P aC++T ransition Guide at the following world wide web URL: 

http://WWW.hp.com/go/C++/ 

The FI P aC++Online Programmer's Guide section Migrating from FIP 
C++(cfront) to FI P aC++contains a subset of the information found in 
the transition guide. 

2. For general background information and experience, subscribe to the 
cxx-dev list server (like a notes group). Send a message to 
majordomo(§cxx.cup.hp.com with the following command in the 
body of the message: subscribe list-name 

Available list-names are as follows: 

cxx-dev HP C++ Development Discussion List 

cxx-dev-announce HP C++ Development Announcements 

cxx-dev-digest HP C++ Development Discussion List Digest 

cxx-dev-announce is also broadcast to cxx-dev, so there is only a need 
to subscribe to one of the lists. The digest also includes both cxx-dev 
and cxx-dev-announce. 

For additional help or information about the list server, send a 
message to majorclomo@;xx.cup.hp.com with the following command 
i n the body of the message: hel p 

3. For specific support questions, contact your FI P support 
representative. 

4. For generic C-H-questions, see documents and URL's listed in the FI P 
aC-H-OnlineProgrammer'sGuide Information Map. 

Some migration issues are listed below: 

• The overload resolution for operators has been updated to reflect the 
latest version of the evolving draft standard. You may see some 
additional "ambiguous" function error messages displayed. 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


• Most frequently reported migration issue: enum x {xl, }; The trailing 
comma is an error. 

• Changestotemporary creation for rvalues used to initialize return 
values which are const references now causes: 

Error 652: Exact position unknown; near file, line#. 
Initialization of the result <some const &> requires creating a 
temporary, yet the temporary's lifetime ends with the return 
from the function. 

• You can bracket your H P aC++changes with the macro defined by the 
draft standard. For example: 

#if _cplusplus >= 199707L 

// HP aC++ Code 

#endif // _cplusplus >= 199707L 

• If you are using directed mode instantiation with the cfront based 
compiler, an awk script can be used to convert your file to an 
instantiation filethat uses the explicit instantiation syntax. Note 
that explicit instantiation syntax can be used to instantiate a 
template and all of its member functions, an individual template 
function, or a tempi ate cl ass's member function. The H P aC++Online 
Programmer's Guidecontains an example script. 

• I n a template, a name with a parameter-dependent qualifier is not 
taken to be a type unless it is explicitly declared as one with the 
typename keyword. 

You need to explicitly declare a type or a member function type using 
the typename keyword when all of the following are true: 

• The code is inside a template. 

• The name is qualified (i.e., it has a "::"token in it). 

• Thequalifier (tothe left of the"::" token) depends on atemplate 
parameter. 

For example, the following code includes the typename keyword to 
declare iterator as a type: 

tinclude <list> 
template <class Element> 
class Foo { 
public: 

list<Element> e; 

typedef typename list<Element>::iterator Mylterator; 

}; 


Chapter 1 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 

For more information, refer to the H P aC++Transition Guide at the 
following World Wide Web URL: 

http://www.hp.com/esy/lang/cpp/tguide 
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Installation Information 

Patch Installation Requirements 


Installation Information 


Read this entiredcxument and any other release notes or readme files 
you may have before you begin an installation. 

To install your software, run theSD-UX swinstall command. It will 
invoke a user interface that will lead you through the installation. For 
more information about installation procedures and related issues, refer 
toManaging HP-UX Softwarewith SD-UX and other README, 
installation, and upgrade documentation provided or described in your 
HP-UX 10.x operating system package. 

Depending on your environment, you may also need documentation for 
other parts of your system, such as networking, system security, and 
windowing. 

HP aC-H-requires approximately 94 MB of disk space: 36MB for the files 
in /opt/aCC and 58 MB for DDE, Blink Link, HP/PAK, and WDB. 


Patch Installation Requirements 


Patch id 


When to install 


PHSS_17872 

PHSS_17225 

PHSS_17903 


HP aC++ run-time libraries, for improved run-time 
performance 

did.si(5) cumulative patch 

ld(l) and som tools cumulative patch, needed to use 
the iobjdebug option and to build shared libraries 
using the -b option. 


PHSS_15389 


millicode library (milli.a) cumulative patch. 


PHKL_8693 

PHKL_8694 

PHSS_17545 

PHCO_14645 


If the sys/time.h header file is used (series 700). 
If the sys/time.h header file is used (series 800). 
If any of the debug (-g) options are used. 

If libc header files are used. 


I n addition, it is recommended that you install the core patches 
distributed on the extension software media. 


Chapter 2 


17 






Installation Information 

Current Linker Required 


Current Linker Required 

HP aC++A.01.21 requires the linker patch, PHSS_17903, (or its 
successor). 

The patch is needed for creation of shared libraries with the-b option. 
(The -mosmartbind option is passed to the linker.) 

The patch is also required in order to use the -tobjdebug option. If the 
patch is not present, the 4objdebug option is ignored and you will not see 
related link-time performance improvements. 


Current Run-time Support Library 
Required 

To work correctly, an application must be linked to or run with an HP 
aC-H-run-time support library (libCsup.a or libCsup.sl) that comes with 
this version of H P aC-H-or a subsequent version. Linking with an older 
version of libCsup.a or running your application with an older version of 
libCsup.sl (the default) may cause spurious failures. 

The following run-time library patch (or its successor) must be installed 
prior to running H P aC-H-: PHSS_17872 


Attention Softbench Users 

You should install Softbench (DDE and PAK) before installing H P aC-H-. 
This is because H P aC-H- is packaged with DDE and a DDE specific 
patch. Not installing in this order results in an unsupported 
configuration. 
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Related Documentation 

Online Documentation 


Related Documentation 


Dcxiu mentation for HP aC++is described in the following sections. 


Online Documentation 

The following online documentation is included with the HP aC++ 
product. 

HP aC++Online Programmer's Guide 

Access the guide in any of the foil owing ways: 

• Use the Thelp command-line option. 

/opt/aCC/bin/aCC +help 

• From your web browser, enter the appropriate U RL: 

file:/opt/aCC/html/C/guide/index.htm (English) 
file:/opt/aCC/html/ja_JP.SJIS/guide/index.htm (Japanese) 

To seeJ apanese characters when using the Netscape browser, choose: 

1. Options 

2. Document Encoding 

3. J apanese (AutoDetect) 

All of the files composing the English version of the guide are installed in 
the /opt/aCC/html/C di rectory. I f you choose to move the enti re guide to a 
different location without having to edit any links, you will need to move 
all of the subdirectories in/opt/aCC/html/C. All of the files composing the 
J apanese guide are installed in/opt/aCC/html/jaJ P.SJ IS/. 

• The English guide (excluding Rogue Wave documentation) is also 
available on the World Wide Web at the following URL: 

http://docs.hp.com/hpux/development/ 
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Related Documentation 

Online Documentation 


Using Templates in HP aC++ 

This technical dcxcument summarizes template features defined in the 
proposed C++standard and describes template instantiation as 
implemented in HP aC++. It is provided with HP aC++in both postscript 
and HTML format in the following locations: 

/opt/aCC/newconfig/TecDocs/tempI ates. ps 

/opt/aCC/newconfig/TecDocs/tempI ates. htm 


NOTE You can select the HTM L version from the initial window of the H P aC++ 

Online Programmer's Guide 


HP-UX Linker and Libraries Online User 
Guide 

This Guide may not be installed on preH P-UX 10.20 systems. I n this 
case, refer to the later section in this chapter, Linker Compatibility 
Warnings, for valuable information. 

To access, use the command: 

/usr/ccs/bin/ld +help 

HP DDE Debugger OnlineHelp 

Select help from the DDE Menu Bar.: 

HP V\4ldebeest Debugger (HP WDB) 

All of the H P WDB documentation is available online in the following 
di rectory: 

/opt/langtools/wdb/doc 

The most current H P WDB and its related documentation is also 
available online at the following World Wide Web directory: 

http://www.hp.com/go/wdb 
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Related Documentation 

Online Documentation 


Rogue V\/^ve Software Standard C++Library 
1.2.1 Class Reference 

This reference provides an alphabetical listing of all of the classes, 
algorithms, and function objects in the Rogue Wave implementation of 
the Standard C++Library. It is provided as HTML formatted files. You 
can view these files if you have access to an HTM L viewer such as 
Netscape. To do so, open thefile/opt/aCC/html/libstd/ref.htm 

Rogue M\iave Softwa re Tool s.h ++ 7.0.6 CI ass 
Reference 

This reference describes all of the classes and functions in theTools.h++ 
Library. It is provided as HTM L formatted files. You can view these files 
if you have access to an HTM L viewer such as Netscape. To do so, open 
the file/opt/aCC/html/l i brwtool/ref.htm 


NOTE Refer to the I nformation Map in the HP aC++Online Programmer's 

Guidefor how to obtain additional Rogue Wave documentation and 
information. 

HP aC++Release Notes 

This is the document you are reading. The online ASCI I file can be found 
i n /opt/aCC/newconfi^Rel N otes/ACXX.release.notes 

HP PA-RISC Compiler Optimization 
Tech nol ogy Wh i te Pa per 

This paper describes the benefits of using optimization. It is available in 
the postscript file/opt/langtools/newconfig/white_papers/optimize.ps 

Online Manual Pages 

Online manual pages for aCC and c++filt are at 
/opt/aC C/sh a r e/ma n/ma n 1. Z. 

Manual pages for theStandard C++Library and thecfront compatibility 
libraries (lOStream and Standard Components) are provided under 
/opt/aCC/share/man/man3.Z. (Note for Standard Components only. 


Chapter 3 


21 




Related Documentation 

Printed Documentation 


invoke a man page by entering 3s after the man command and before the 
man page name. For example, to invoke the man page for Args: man 3s 
Args) 

J apanese man pages are located at: 

/opt/aCC/share/man/ja_JP.eucJP/manl.z and 

/opt/aCC/share/man/ja_JP.eucJP/man3.z (euc character set) 

/opt/aCC/share/man/ja_JP.SJlS/manl.z and 

/opt/aCC/share/man/ja_JP.SJIS/man3.z (SJIS character set) 


Online C++Example Source Files 

Online C++example source files are located in the directory, 
/opt/aCC/contrib/Examples/RogueWave. These include examples for the 
Standard C++Library and for theTools.h++Library. 


Printed Documentation 

• HP aC++Release Notes is this document. A printed copy of the 
release notes is provided with the H P aC++product. 

Release notes are also provided online, as noted above. 


Other Documentation 

Refer to the H P aC++Online Programmer's Guidel nformation Map for 
documentation listings, URL's, and course information related to the 
C++ language. Also, see below. 

The following documentation is avail able for use with HP aC++.Toorder 
printed versions of Hewlett-Packard documents, refer to manuals(5). 

• HP/ DDE Debugger User's Guide contains information on debugging 
C-H-programs with the HP Distributed Debugging Environment on 
the H P 9000. 
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HP aC++World Wide Web Homepage 

Access the HP aC++World Wide Web Homepage at the following URL: 

http://www.hp.com/go/C++ 

Refer to the Homepagefor the latest information regarding: 

• Frequently Asked Questions 

• Release Version and Patch Table 

• Purchase and Support I nformation 

• Documentation Links 

• Compatibility between Releases 

Compatibility between HP aC++Releases 

Maintaining binary compatibility is a key release requirement for new 
versions of H P aC++. The compiler has maintained the same object 
model and calling convention and remains compatible with the HP-UX 
runtime in the code that it generates as well as its intrinsic runtime 
library (libCsup) across the various releases of H P aC-H-and its run-time 
patch stream. 

For the Standard Template Library (libstd) and a generic component/tool 
library (librwtool), HP aC-H-(as well as some other C-H-compilers) relies 
on Rogue Wave's Standard Library and Tools.h-H-libraries. From the 
initial release of HP aC-H-through the patch release of version A.01.06, 
Rogue Wave's Standard Library version 1.2 and Tools.h-H-version 7.0.3 
compatible libraries were bundled with the compiler. 

At the release of H P aC-H-A.01.07, the runti me I i braries were updated to 
Rogue Wave's Standard Library version 1.2.1 and Tools.h-H-version 
7.0.6. These new libraries introduced additional data members in some 
base classes resulting in incompatibility with the previous versions. For 
more details, refer to the HP aC-H-World Wide Web Homepage at the 
following URL and choose Compatibility between Releases: 

http://www.hp.com/go/C++ 
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Floating-Point Exceptions Must be Raised 
Prior to Entering Library Routines 

Programmers who use floating-point arithmetic are reminded to insure 
that floating-point exceptions are raised before entering a library 
routine. For example a floating-point divide should be followed by a 
floating-point store. If you fail to do so, code within the library may raise 
the floating-point exception, interrupting the library code rather than 
the user code. 

This reminder is included si nee the unwind component of libel.a and 
libel.si uses floating-point operationsin morepi aces than earlier versions 
of the library. HP aC-H-uses unwind functionality to support 
throw/catch exception handling. Programs which don't raise 
floating-point exceptions before entering unwind library routines may 
have the exception raised from within the unwind routine. 

Content of .o Files may Change 

The following applies when you use an aCC command-line option that 
invokes the assignee. 

The content of a given . 0 file can potentially change when it is used in a 
closure (with the -Hnst_close option) or link operation. The change may 
occur in either of the foil owing cases: 

• You change the order of .0 file's on the link line. For example, if you 
compile and link A.cand B.c multi pie times as follows, the contents of 
A.oand B.o may not be the same foil owing the second link as they 
were following the first link: 

aCC -c A.c B.c 
aCC A.o B.o 

aCC -c A.c B.c 
aCC B.o A.o 

• You link a .0 file with different objects. In the following example, the 
content of A.o may not be the same foil owing the second link as it was 
following the first link: 

aCC A.o B.o 
aCC A.o C.o 
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The Named Return Value (NRV) Optimization 

Syntax: -Wc,-nrv_optimization, [off Ion] 

The above syntax disables (default) or enables the named return value 
(NRV) optimization. For this optimization to work correctly in 
conjunction with exception handling, the application must delinked to 
an aC++run-time support library that comes with HP aC-H-A.01.04 or a 
subsequent version. Linking with a prior library may cause spurious 
failures. If the shared version of this library is selected (default), the 
platform on which the application is run must also have that release of 
the HP aC-H-run-time support library (libCsup.sl). 

The NRV optimization eliminates a copy-constructor call by allocating a 
local object of a function directly in the caller's context if that object is 
always returned by the function. For example: 

struct A { 

A(A constS); // copy-constructor 

); 


A f(A constS x) { 

A a(x); 

return a; // Will not call the copy constructor if the 
) // optimization is enabled. 

This optimization will not be performed if the copy-constructor was not 
declared by the programmer. Note that although this optimization is 
allowed by the I SO/ANSI C-H-working paper, it may have noticeable 
side-effects. 

Example: aCC -Wc,-nrv_optimization,on app.C 

Linker Compatibility V\/brnings 

Beginning with the H P-UX 10.20 release, the linker generates 
compatibility warnings. These warnings include H P 9000 architecture 
issues, as well as linker features that may change over time. 

Compati bi I ity warni ngs can be turned off with the 
-H/[no]compatwarnings linker option. Also, detailed warnings can be 
turned on with the -tvallcompatwarnings linker option. 

Link time compatibility warnings include the foil owing: 

• Linking PA-RI SC 2.0 object files on any system — PA-RI SC 1.0 
programs will run on 1.1 and 2.0 systems. PA-RI SC 2.0 programs will 
not run on 1.1 or 1.0 systems. 
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• Dynamic linking with -A — If you do dynamic linking with -A, you 
should migrate to using the Shared Library Management Routines. 
These routines are also described in thesh_load(3X) man page. 

• Procedure call parameter and return type checking (which can be 
specified with -C) — The current linker checks the number of 
symbols, parameters, and procedure calls across object files. I n a 
future release, you should expect H P compilers to perform 
cross-module type checking, instead of the linker. This impacts H P 
Pascal and HP Fortran programs. 

• Duplicate names found for code and data symbols — The current 
linker can create a program that has a code and data symbol with the 
same name. I n a future H P-UX release, the linker will adopt a single 
name space for all symbols. This means that code and data symbols 
cannot share the same name. Renaming the conflicting symbols 
solves this problem. 

• Unsatisfied symbols found when linking to archive libraries — If you 
specifythe-v option with the -K/allcompatwarningsoption and linkto 
archive libraries, you may see new warnings. 

• Versioning within a shared library — If you do versioning within a 
shared library with the HP_SH LI B_VE RSI ON (C and C-H-) or the 
SHLIB_VERSION (Fortran and Pascal) compiler directive, you 
should migrate to the industry standard and faster performing 
library-level versioning. 
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Problem Descriptions and Fixes 
and Known Limitations 


This chapter summarizes the known problems and limitations of the 
current version of H P aC++except as otherwise noted. 

HP-UX 10.10 is the last supported OS for PA-RISC 1.0 architecture 
machines. H P-UX 10.20 no longer supports execution of PA-RI SC 1.0 
code, and 10.20 compilers no longer support the compilation of PA-RISC 
1.0 code. 

Seethe latest HP-UX Software Status Bulletin support document for 
other known problems. 


Known Problems 

Customers on support can use the product number to assist them in 
finding SSB and SRB reports for H P aC-H-. The product number you can 
search for is B3910BA. 

To verify the product number and version for your HP aC-H-compiler, 
execute the following HP-UX commands: 

what /opt/aCC/lbin/ctcom 
what /opt/aCC/bin/aCC 

To verify the product number and version for the linker: 

what /usr/ccs/bin/ld 

To verify the product number and version for the shared library loader: 

what /usr/lib/dld.si 

Your system, if correctly installed, should have a symbolic link from 
/usr/l i b/aCC/dId.sl to /usr/l i b/did.sl 

Following are known problems and workarounds. 
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Incompatibilities Between the Standard C++ 
Library and the Draft Standard 

As the I SO/ANSI C++standard has evolved over time, the Standard C++ 
Library has not always kept up. Such is the case for the "times" function 
object in the functional header file. In the standard, "times" has been 
renamed to "multiplies." 

If you want to use "multiplies" in your code, to be compatible with the 
ISO/ANSI C++standard, use a conditional compilation flag on the aCC 
command line. 

For example, for the following program, compile with the command line: 
aCC -D_HPACC_USING_MULTIPLIESJN_FUNCTIONAL test.c 

// test.c 

int times; //user defined variable 

#include <functional> 

// multiplies can be used in 


int main{) {} 

// end of test.c 

Depending on the existence of the conditional compilation flag, 
functional defines either "times", or "multiplies", not both. 

So, if you have old source that uses "times" in header functional and also 
new source that uses "multiplies", the sources cannot be mixed. Mixing 
the two sources would constitute a non-conforming program, and the old 
and new sources may or may not link. 

If your code uses the old name "times," and you want to continue to use 
the now non-standard "times" function object, you do not need to do 
anything to compile the old source. 

Unsatisfied Symbols if Using Non-current 
Run-time Support Library 

If you see a message I ike the foil owing, you may be using a non-current 
version of the FI P aC-H-run-time support library. 

/opt/aCC/lbin/ld: Unsatisfied symbols: 

Class tables [Vtable] dependent on key function: 

''_versioned_type_info::~_versioned_type_info()" (data) 
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For example, if you are a library distributor, you must ensure that your 
customers use the same or a newer version oHhe libCsup run-time 
library as you. If necessary, you should install the most current FI P 
aC-H-library support patch and distribute this patch to your customers. 

As of the date of these release notes, the most current library support 
patch number is: PFISS_17872 

Unsatisfied Symbols for Inline Template 
Functions 

If you use explicit instantiation instead of closing a library, and you 
compile with the-i-inst_auto option, then unsatisfied symbols will be 
generated for inline template functions that aretoo large to inline. 

Syntax Errors when Using 
/usr/i ncl ude/sys/ti me.h 

• I f you see the fol lowi ng error message, it means that 
CLOCKS_PER_SEC is not defined: 

Error 171: "7198.C", line 2 # Undeclared variable 
'CLOCKS_PER_SEC'. int i = CLOCKS_PER_SEC; 

To correct the problem, you can install the appropriate patch listed 
below (or any successor patch) or implement the workaround 
described below: 

PHKL_8691 series 700 HP-UX 10.10 

PHKL_8692 series 800 


PHKL_8693 series 700 HP-UX 10.20 

PHKL_8694 series 800 

The workaround is to modify the/usr/i ncl ude/sys/ti me.h file as 
follows: 

1. Find the first occurence of: 

#endif /* _INCLUDE_STDC_ */ 

2. I mmediately before the first occurence of the above line, add the 
following code, replacing SomeValue with the value you need 
(1000000 would be the system default): 
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#else 

#ifdef _cplusplus 

#define CLOCKS.PER_SEC SomeValue 
#endif 

• The/usr/include/sys/time.h filecontains a K & R stylefunction 
declaration for which HP aC++generates an error I ike the foil owing: 

Error 43: "/usr/include/sys/time.h", line 487 # C++ does not 
allow 

Old-style (non-prototype) function definitions. 


To workaround, whenever tirneh is included by a source program, 

you can define the_STDC_macro on your command-line, as in the 

following example: 

aCC -D_STDC_ 

• HP aC-H-generatres an error I ike the foil owing stating that structsor 
any types cannot be declared extern. 

Error 608: "/usr/include/sys/time.h", line ??? # Types may not 
be 

declared static, auto, register, extern or mutable, 
extern struct sigevent; 


The error is caused by a problem in the/usr/include/sys/time.h file. 
To workaround, you can change the line extern struct sigevent; in 
thetime.h fileto: 

struct sigevent; 

Or you can install the appropriate patch listed below: 

PHKL_8693 series 700 HP-UX 10.20 

PHKL_8694 series 800 

Syntax Problems when Using 
/usr/i ncl ude/math .h 

To resolve a conflict between the exception struct in 
/usr/include/sys/math.h and the aC-H-except!on struct, you can install 
the appropriate patch, currently PHCO_14645 (or any successor patch). 
Alternatively, you can implement the workaround described below. 

The workaround is to modify the/usr/include/math.h file as follows: 

1. Find the line: 

tdefine _MATH_INCLUDED 
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2. I mmediately following the above line, add the next line: 

#define exception math_exception 

3. Find the line: 

#endif /* _MATH_INCLUDED */ 

4. I mmediately before the above line, add this line: 

#undef exception 

V\/^rni ngs when using /usr/i nclude/rpc/xdr.h 

Compile-time warnings I ike the following should be ignored. They are 
caused by an incorrect prototype in the/usr/i ncl ude/rpc/xdr.h file. 

Warning 301: "/YourFileName/usr/include/rpc/xdr.h", line 276 # The 
(...) parameter list is a non-portable feature. 

extern bool_t xdrrec_eof{_o); /* true iff no more input */ 

NOTE Warning 302 is now a suggestion and only occurs with the 4w option. 


Binary Compatibility 

An application that ran on previous FIP-UX 10.x releases (10.01, 10.10, 
or 10.20) will generally continue to run with the same behavior with this 
10.20-based FIP aC-H-release provided that any dependent shared 
libraries are also present. An executable is a binary file that has been 
processed by the FI P linker with Id or indirectly with the compiler, and 
can be run by the FI P-UX loader(exec). 

The following items describe exceptions to binary compatibility between 
the previous 10.20 and current releases. These conditions can occur 
during your development process, but rarely affect deployed applications. 

Binary I ncompatibiIities without Changes 

Under the following conditions, when you compile your source code 
without any changes (to source code, options, or makefiles), you can 
create relocatable object files or executables that cannot be moved back 
to a previous 10.x system. 

• Instrumented code with PBO or 404 optimization 
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If you use P BO (-H compiler or linker option) or the 404 option during 
development and recompile with your current compiler, you may 
create instrumented objects (I SOM) that a previous system does not 
recognize. 


NOTE This code may not be backward-compatible with previous 10.x releases. 

I n general, you cannot move instrumented object files backward. 


I f you move an I SOM across operating system versions, for example, 
from an 11.x system to a 10.x system, you may receive the following 
error: 

Error at line 0: Backend Assert ** Ucode versions earlier then 
V.4 no longer supported. (5172) 

Binary Incompatibilities with Changes 

When you make changes to your source code, options, or makefiles to use 
new features of the current release, you can introduce the foil owing area 
of binary incompatibility. 

• Open Graphics Library (OGL) Support 

This release provides OGL support to improve performance. If you 
make changes to your source code to recompile using the OGL 
headers, you receive the message "invalid fixup" when you link your 
relocatable object file or run your executable on a previous 10.x 
system.. 


Known Limitations 

Someof these limitations will be removed in future releases of HP aC-H-. 
Please be aware that someof these limitations are platform-specific. 

• H P aC-H-does not support the xdb debugger. I nstead, use the H P 
WDB Debugger or the H P/DDE Debugger supplied with the product. 

• HP aC-H-does not and will not in the future support installation 
and/or execution on H P-UX 9.x, 10.00, or 10.01 systems. 

• HP aC-H-does not support large files (i.e., greater than 2 GB) with 
<iostream.h>. 
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• Note that although the compiler will run on the PA Rl SC 1.0 
architecture, an HP aC++executable will run only on the PA RISC 
1.1 or later architecture. 

• Known limitations of exception handling features: 

• I nteroperability with setjmp/longjmp (undefined by theC++draft 
proposed international standard) is unimplemented. Executing 
longjmp does not cause any destructors to be run. 

• If an unhandled exception is thrown during program initialization 
phase (that is, before the main program begins execution) 
destructors for some constructed objects may not be run. 

• Symbolic debugging information is not always emitted for objects 
which are not directly referenced. For instance, if a pointer to an 
object is used but no fields are ever referenced, then HP aC++only 
emits symbolic debug information for the pointer type and not for 
the type of object that the pointer points to. For instance, use of 
Widget * only emits debug information for the pointer type 
Widget* and not for Widget. If you wish such information, you can 
create an extra source file which defines a dummy function that 
has a parameter of that type (Widget) and link it into the 
executable program. 

• Known limitations of signal handling features: 

• Throwing an exception in a signal handler is not supported, since 
a signal can occur anyplace, including optimized regions of code 
in which the values of destructable objects are temporarily held in 
registers. Exception handling depends on destructable objects 
being up-to-date in memory, but this condition is only guaranteed 
at call sites. 

• Issuing a longjmp in a signal handler is not recommended for 
the same reason that throwing an exception is not supported. 

The signal handler interrupts processing of the code resulting 
in undefined data structures with unpredictable results. 

• Source-level debuggingofC-H-shared libraries is supported. 
However, there are limitations related to debugging C-H-shared 
libraries, generally associated with classes whose member functions 
are declared in a shared library, and that have objects declared 
outside the shared library wherethe class is defined. Refer to the 
appropriate release notes and manuals for the operating system and 
debugger you are using. 
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Refer also to the Software Status Bulletin for additional details. 

• I nstantiation of shared objects in shared memory is not supported. 

• When you call the <shl_load>{3) routines in libdid.sl either directly or 
indirectly (as when your application calls use the 4A option) you will 
see an "unresolved externals" error. 

If you want to link archive libraries and libdid.sl, usethe-WI,-a, 
archive option. The following example directs the linker to use the 
archive version of standard libraries and (by default) libdid.sl. 

aCC prog.o -W1,-a,archive 

• Using shl_load(3X) with Library-Level Versioning 

Once library-level versioning is used, calls to shl_load() (see 
shl_load(3X)) should specify the actual version of the library that is to 
be loaded. For example, if libA.sl is now a symbolic link to libA.l, then 
calls to dynamically load this library should specify the latest version 
available when the application is compiled, such as: 

shl_load("libA.l", BIND_DEFERRED, 0); 

This will insure that, when the application is migrated to a system 
that has a later version of libA available, the actual version desired is 
the one that is dynamically loaded. 

• Memory Allocation Routine allocaO 

The compiler supports the built in function, alloca, defined in the 
/usr/include/alloca.h header file. The implementation of the allocaO 
routine is system dependent, and its use is not encouraged. 

allocaO is a memory allocation routine similar to mallocO (see 
malloc(3C)). The syntax is: 

void *alloca (size_t <size>); 

allocaO allocates space from the stack of the caller for a block of at 
least <size> bytes, but does not initializethe space. The space is 
automatically freed when the cal ling routine exits. 


NOTE Memory returned by allocaO is not related to memory allocated by other 

memory allocation functions. Behavior of addresses returned by allocaO 
as parameters to other memory functions is undefined. 


To use this function, you can use the <alloca.h> header file. 


34 


Chapter 4 




